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(57) Abstract: The present invention discloses a method and apparatus for a mobile station application to identify specified events 
in a wireless communication system. The present invention includes an application program interface (API) that facilitates com- 
munications between a mobile station communication protocol stack, which communicates with a communication network, and a 
mobile station application. The API enables at least one of the specified events based on its state. The mobile station application 
then identifies the specified events that are enabled. 
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1 

METHOD AND APPARATUS FOR A MOBILE STATION 
APPLICATION TO IDENTIFY SPECIFIED EVENTS 

BACKGROUND 

1. Field of the Invention 

This invention generally relates to the field of wireless communications. 
More particularly, the present invention relates to a novel method and 
apparatus that enables a mobile station application to identify specified events 
in a wireless communication system. 



2. Description of Related Art 

A. Wireless Communications 

Recent innovations in wireless communication and computer-related 
technologies, as well as the unprecedented growth of Internet subscribers, have 

15 paved the way for mobile computing. In fact, the popularity of mobile 
computing has placed greater demands on the current Internet infrastructure to 
provide mobile users with more support. The life blood of this infrastructure is 
the packet-oriented Internet Protocol (IP) which provides various services, 
including the addressing and routing of packets (datagrams) between local and 

20 wide area networks (LANs and WANs). IP protocol is defined in Request For 
Comment 791 (RFC 791) entitled, "INTERNET PROTOCOL DARPA 
INTERNET PROGRAM PROTOCOL SPECIFICATION/' dated September 
1981. 

The IP protocol is a network layer protocol that encapsulates data into IP 
25 packets for transmission. Addressing and routing information is affixed to the 
header of the packet. IP headers, for example, contain 32-bit addresses that 
identify the sending and receiving hosts. These addresses are used by 
intermediate routers to select a path through the network for the packet 
towards its ultimate destination at the intended address. Thus, the IP protocol 
30 allows packets originating at any Internet node in the world to be routed to any 
other Internet node in the world. On the other hand, a transport layer, which 
comprises either a Transmission Control Protocol (TCP) or a User Datagram 
Protocol (UDP), is used to address to particular applications. 

The current trend is for mobile users to use mobile computers, such as 
35 laptop or palmtop computers, in conjunction with wireless communication 
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devices, such as cellular or portable phones, to access the Internet. That is, just 
as users conventionally employ "wired" communication devices to connect 
their computers to land-based networks, mobile users will use wireless 
communication devices, commonly referred to as "mobile stations' 7 (MSs), to 
5 connect their mobile terminals to such networks. As used herein, the mobile 
station or MS will refer to any subscriber station in the public wireless radio 
network. 

FIG. 1 (Prior Art) illustrates a high-level block diagram of a wireless data 
communication system in which the MS 110 communicates with an 

10 Interworking Function (IWF) 108 via a Base Station/ Mobile Switching Center 
(BS/MSC) 106. The IWF 108 serves as the access point to the Internet. IWF 108 
is coupled to, and often co-located with, BS/MSC 106, which may be a 
conventional wireless base station as is known in the art. Another standard 
protocol that addresses the wireless data communication system is the 3 rd 

15 Generation Partnership Project 2 ("3GPP2") entitled "WIRELESS IP NETWORK 
STANDARD," published in December 1999. The 3G Wireless IP Network 
Standard, for example, includes a Packet Data Serving Node ("PDSN"), which 
functions like the IWF 108. 

There are various protocols that address the data communications 

20 between the MS 110 and the IWF 108. For example, Telecommunications 
Industry Association (TIA)/ Electronics Industries Association (EIA) Interim 
Standard IS-95, entitled "MOBILE STATION-BASE STATION 
COMPATIBILITY STANDARD FOR DUAL-MODE WIDEBAND SPREAD 
SPECTRUM CELLULAR SYSTEM," published in July 1993, generally provides 

25 a standard for wideband spread spectrum wireless communication systems. 
Moreover, standard TIA /EIA IS-707.5, entitled "DATA SERVICE OPTIONS 
FOR WIDEBAND SPREAD SPECTRUM SYSTEMS: PACKET DATA 
SERVICES/ 7 published in February 1998, defines requirements for support of 
packet data transmission capability on TIA /EIA IS-95 systems and specifies 

30 packet data bearer services that may be used for communication between the 
MS 110 and the IWF 108 via the BS/MSC 106. Also, the TIA /EIA IS-707-A.5 
standard, entitled "DATA SERVICE OPTIONS FOR SPREAD SPECTRUM 
SYSTEMS: PACKET DATA SERVICES," and the TIA /EIA IS-707-A.9 standard, 
entitled "DATA SERVICE OPTIONS FOR SPREAD SPECTRUM SYSTEMS: 
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HIGH-SPEED PACKET DATA SERVICES/' both published in March 1999, also 
define requirements for packet data transmission support on TIA/EIA IS-95 
systems. In addition, another standard protocol that addresses 
communications between the MS 110 and the IWF 108 is the TIA/EIA IS-2000, 
5 entitled "INTRODUCTION TO CDMA 2000 STANDARDS FOR SPREAD 
SPECTRUM SYSTEMS/ 7 published in July 1999. 

IS-707.5 introduces communication protocol option models between the 
MS 110 and the BS/MSC 106 (the Um interface), and between the BS/MSC 106 
and the IWF 108 (the L interface). For instance, a Relay Model represents the 

10 situation where a Point to Point Protocol (PPP) link exists on the Um interface 
between the MS 110 and the IWF 108. The PPP protocol is described in detail in 
Request for Comments 1661 (RFC 1661), entitled "THE POINT-TO-POINT 
PROTOCOL (PPP)/' 

FIG. 2 (Prior Art) is a diagram of the protocol stacks in each entity of the 

15 IS-707.5 Relay Model. At the far left of the figure is a communication protocol 
stack, shown in conventional vertical format, showing the protocol layers 
running on the MS 110. The MS 110 protocol stack is illustrated as being 
logically connected to the BS/MSC 106 protocol stack over the Um interface. 
The BS/MSC 106 protocol stack is, in turn, illustrated as being logically 

20 connected to the IWF 108 protocol stack over the L interface. 

The operation depicted in Fig. 2 is as follows: an upper layer protocol 
200 entity, such as an application program running on the MS 110, has a need to 
send data over the Internet. A representative application may be a web 
browser program (e.g., Netscape Navigator™, Microsoft Internet Explorer™). 

25 The web browser requests a Universal Resource Locator (URL), such as 
HYPERLINK " http://www.Oualcomm.com/ ". A Domain Name System 
(DNS) protocol, also in the upper layer protocol 200, translates the textual host 
name www.Oualcomm.com to a 32-bit numeric IP address by the use of a 
domain name resolution, which translates names to addresses in the Internet. 

30 The Hypertext Transfer Protocol (HTTP), which is also an upper layer protocol 
200, constructs a GET message for the requested URL, and specifies that TCP 
will be used to send the message and for HTTP operations. The transport layer 
202 uses port 80, which is known in the art, as the destination port to route the 
HTTP operations to the application. 
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The TCP protocol, which is a transport layer protocol 202, opens a 
connection to the IP address specified by DNS and transmits the application- 
level HTTP GET message. The TCP protocol specifies that the IP protocol will 
be used for message transport. The IP protocol, which is a network layer 
5 protocol 204, transmits the TCP packets to the IP address specified. The PPP, 
which is a link layer protocol 206, encodes the IP packets and transmits them to 
the relay layer protocol 208. An example of the relay layer protocol 208 may be 
the illustrated TIA/EIA-232F standard, which is defined in "INTERFACE 
BETWEEN DATA TERMINAL EQUIPMENT AND DATA CIRCUIT- 

10 TERMINATING EQUIPMENT EMPLOYING SERIAL BINARY DATA 
INTERCHANGE/' published in October 1997. It is to be understood that other 
standards or protocols known to artisans of ordinary skill in the art may be 
used to define the transmission across the layers. For example, other applicable 
standards may include the "UNIVERSAL SERIAL BUS (USB) 

15 SPECIFICATION, Revision 1.1," published in September 1998, and the 
''BLUETOOTH SPECIFICATION VERSION 1.0A CORE/' published in July 
1999. Last, the relay layer protocol 208 passes the PPP packets to a Radio Link 
Protocol (RLP) 210 and then to the IS-95 protocol 212 for transmission to the 
BS/MSC 106 over the Um interface. The RLP protocol 210 is defined in the IS- 

20 707.2 standard, entitled "DATA SERVICE OPTIONS FOR WIDEBAND 
SPREAD SPECTRUM SYSTEMS: RADIO LINK PROTOCOL/' published in 
February 1998, and the IS-95 protocol is defined in the IS-95 standard identified 
above. 

A complementary relay layer protocol 220 on the BS/MSC 106 receives 
25 the PPP packets over the Um interface through a IS-95 layer 218 and then a RLP 
layer 216. The relay layer protocol 220 passes them over the L interface to a 
relay layer protocol 228 on the IWF 108. A PPP protocol link layer 226 on the 
IWF 108 receives the PPP packets from the relay layer protocol 228, and 
terminates the PPP connection between the MS 110 and the IWF 108. The 
30 packets are passed from the PPP layer 226 to a IP layer 224 on the IWF 108 for 
examination of the IP packet header for final routing, which in this scenario is 
www.Oualcomm.com . 

Assuming that the ultimate destination of the IP packets generated by 
the MS 110 is not the IWF 108, the packets are forwarded through the network 
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layer protocols 224, and link layer protocols 225 to the next router (not shown) 
on the Internet. In this manner, IP packets from the MS 110 are communicated 
through the BS/MSC 106, and the IWF 108 towards their ultimate intended 
destination in the Internet in accordance with the IS- 707.5 standard relay 
5 model. 

Before the MS 110 packets reach their destination, the data link 
connection must be established first. As specified in RFC 1661, this requires 
each end of the point-to-point link (i.e., the PPP protocols 206 and 226) to first 
send PPP Link Control Protocol (LCP) packets in order to establish, configure 

10 and test the data link connection. After the link has been established by the 
LCP, the PPP protocol 206 may then send Network Control Protocol (NCP) 
packets to configure the network layer protocols 204 and 224. The NCP for IP 
in PPP links is the IP Control Protocol (IPCP). IPCP is described in detail in 
Request for Comment 1332 (RFC 1332), entitled "THE PPP INTERNET 

15 PROTOCOL CONTROL PROTOCOL (IPCP)," published in May 1992. Before 
IPCP negotiation, however, an authentication phase may be needed. After each 
of the network layer protocols has been configured, packets from each network 
layer protocol can be sent over the link between them. 

20 B. Application Program Interface 

Most, if not all, of the processes supporting the communication protocol 
stack on the MS 110 are executed by application programs. Generally, 
conventional data networks employ application program interfaces (APIs) to 
enable application programs running on one computer to communicate with 

25 application programs running on another computer. The APIs utilize "sockets," 
which shelter the invoking applications from differences in the protocols of the 
underlying network. To achieve inter-networked communications, APIs 
comprise functions, which allow the applications, for example, to open a socket, 
transmit data to the network, receive data from the network, and close the 

30 socket. Common network programming interfaces include Berkeley Systems 
Development (BSD) sockets interface, which operates under a Unix™ operating 
system, and Windows™ Sockets Interface (WinSock™), which operates under a 
Windows™ operating system. 

Because neither BSD sockets nor WinSock™ supports the 
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communication protocol stack on the wireless MS 110 (see FIG. 2), a novel API 
supporting such a stack is needed. In particular, what is needed is a novel 
method and apparatus for a mobile station application to identify specified 
events in a wireless communication system. 

5 

SUMMARY OF THE INVENTION 

The present invention addresses the need identified above by providing 
a method and apparatus for a mobile station application to identify specified 
events in a wireless communication system. In one implementation, the present 

10 invention includes an application program interface (API) that facilitates 
communications between a mobile station communication protocol stack, 
which communicates with a communication network, and a mobile station 
application. The API enables at least one of specified events based on its state. 
The mobile station application then identifies the specified events that are 

15 enabled. 



BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 (Prior Art) is a high level block diagram of a wireless 
communication system in which a mobile station connects to the Internet. 
20 FIG. 2 (Prior Art) schematically describes the protocol stacks in each 

entity of the TIA/EIA IS-707.5 Relay Model. 

FIG. 3 schematically depicts features of an embodiment of the present 
invention. 

FIGS. 4 and 5 are flow charts for detecting a specified event. 
25 FIG. 6 is a block diagram depicting an asynchronous connection. 

FIG. 7 is a block diagram depicting an asynchronous socket input. 
FIGS. 8-10 are state diagrams of embodiments of the present invention. 



DETAILED DESCRIPTION 

30 The embodiments of the present invention may be realized in a variety of 

implementations, including software, firmware, and/or hardware. Hence, the 
operation and behavior of the present invention will be described without 
specific reference to the software code or hardware components, it being 
understood that a person of ordinary skill in the art would be able to design 
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software and /or hardware to implement the present invention, which enables a 
mobile station application to identify specified events, based on the description 
herein. 

FIG. 3 depicts an application 260, a communication protocol stack 280, 
5 and an API 270 within a MS 110. Application 260 and communication protocol 
stack 280 (i.e., protocol layers 202, 204, 206, 208, 210, 212) communicate through 
function calls, which are provided by API 270. In other words, API 270 allows 
application 260 and communication protocol stack 280 to run on different 
processors and operating systems without compromising functionality. One 

10 skilled in the art would appreciate that various names for the invoked functions 
are possible without departing from the scope of the present invention. 

It should be noted that communication protocol stack 280 contains a 
plurality of send queues and receive queues, which store data. Output functions 
read data from a memory of application 260 to store the data into one of the 

15 send queues of communication protocol stack 280. Input functions read data 
from one of the receive queues of communication protocol stack 280 to store the 
data into the memory of application 260. 

To illustrate operation, the MS 110 receives IP packets. The 
communication protocol stack 280 of the MS 110 unencapsulates the IP packets, 

20 and passes them to the transport layer 202 (see FIG. 3). A field in the IP packet 
header indicates the transport, which may be either TCP or UDP. Based on the 
destination port number specified in the transport layer header, the data is 
routed to the appropriate receive queue of communication protocol stack 280, 
which corresponds to a particular socket. The data may then be transmitted to 

25 application 260. 

In certain situations, it may be desirable to operate with packets that 
bypass various layers of the protocol stack 280 to reduce latency effects. Such 
packets include raw packetized data, such as raw IP packets, which lack 
destination information (i.e., destination port number). As such, the destination 

30 application may not be determined from the raw IP packets. In such situations, 
communication protocol stack 280 may transmit the received raw IP packets to 
all sockets registered to support the IP protocol, for example. This allows the 
payload data to be transmitted to the destination application. An Internet 
Control Messaging Protocol (ICMP) parsing engine, which responds to IP 
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packets, may also receive the raw packetized data. The well-known ICMP 
parsing engine is defined in RFC 792, entitled "INTERNET CONTROL 
MESSAGE PROTOCOL/' It should be apparent from this description that 
communication protocol stack 280, for example, processes the received packets 
5 before it passes them up the stack to application 260, which reduces the amount 
of unencapsulation to be done by application 260. 

Conversely, application 260 may transmit raw packetized data over the 
Um interface by using the sockets, which facilitates communications between 
communication protocol stack 280 and application 260. Further, application 260 

10 may transmit raw packetized data over the Um interface. In turn, 
communication protocol stack 280 encapsulates the packetized or raw 
packetized data, for example, into IP packets and transmits them over the Um 
interface. In this example, communication protocol stack 280 provides a IP 
header and a checksum in order to generate the IP packets. For ICMP, on the 

15 other hand, a specified protocol type may be copied into the IP header. 

As stated above, application 260 may create a socket that allows data 
communications between at least one of the protocol layers 202, 204, 206, 208, 
210, 212 and application 260 to reduce the latency inherent in the use of 
communication protocol stack 280. That is, application 260 may create a socket 

20 that bypasses the transport layer 202, the network layer 204, and the link layer 
206, and thus allows application 260 to transmit payload data to, or receive 
payload data from, the RLP layer 210. Also, application 260 may create a socket 
that allows application 260 to transmit payload data to, or receive payload data 
from, the IS-95 layer 212. 

25 In one embodiment, application 260 calls a function open_netlib ( ) to 

open communication protocol stack 280 and to assign an application 
identification. The application identification allows multiple applications to 
communicate with communication protocol stack 280 (i.e., multi-tasking). As 
part of the call to function open_netlib ( ), for example, application 260 specifies 

30 a pointer to a network callback function and to a socket callback function. The 
network callback function is invoked to inform application 260 whenever 
network subsystem specified events, such as read from, write to, and close the 
traffic channel (i.e., Um) and /or a link-layer (i.e., PPP 206), have occurred (or 
have been enabled). The socket callback function is invoked to inform 
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application 260 whenever socket specified events, such as read from, write to 
and close the transport layer (i.e., TCP), have occurred (or have been enabled). 
It should be apparent to one skilled in the art that a communication network 
comprises at least one of the traffic channel, the link-layer, and the transport 
5 layer. 

Once communication protocol stack 280 has been opened, a function 
pppopen ( ) is called to initiate a network subsystem connection, which includes 
the traffic channel and the link-layer. This is an application-wide call, which is 
not dependent on an individual socket. It, however, requires the application 

10 identification. Upon the establishment or failure of the network subsystem 
connection, the network callback function is invoked to provide a specified 
event notification. The network subsystem fails, for example, if the traffic 
channel is not established. Further, the network subsystem characteristics may 
be set with a call to function net_ioctl ( ). This call, for example, may specify the 

15 data rate of the sockets. 

Once the network subsystem connection is established, a socket (or 
sockets) can be created and initialized through a call to function socket ( ). 
Before the socket functions can be used, however, the call to function socket ( ) 
may return a socket descriptor. Then, application 260 may call a function 

20 async_select ( ) to register specified events to receive asynchronous notification. 
This registration may be implemented by application 260, as part of the function 
call, to specify the socket descriptor and a bit mask (i.e., multiple events OR'ed 
together) of the specified events requiring notification. If a specified event 
occurs (i.e., it is enabled), and it is detected by communication protocol stack 

25 280 or API 270, for example, the socket callback function is invoked to provide 
asynchronous notification. The callback function may notify application 260 of 
the specified event by the use of a signal, a message, including a message over 
remote procedure call (RPC), or a hardware or software interrupt. 

Once application 260 is notified of the specified event, then it may call 

30 function getnextevent ( ) to determine the specified events to service. This 
function returns a mask of the specified events that occurred for the specified 
socket descriptor. Also, it clears the bits in the mask of the specified events that 
occurred. Thus, application 260 may no longer receive notification of the 
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disabled specified events. Application 260 must re-register (i.e., re-enable) these 
specified events through a subsequent call to function async_select ( ). 

In addition, application 260 may change the specified events registered 
for by clearing corresponding bits in the bit mask of specified events. If the bit is 
5 already cleared in the bit mask, then the request is simply ignored. In short, 
event notification may be disabled on a per-event basis, for example, through a 
call to function async_deselect ( ). 

FIGS. 4 and 5 are flow charts for detecting the specified events. As shown 
in FIG. 4, for example, communication protocol stack 280 waits for application 

10 260, in block 400, to register a specified event. After the specified event is 
registered, communication protocol stack 280, in block 402, polls a memory. In 
block 404, the specified event may be detected based on the polled information 
of block 402. In block 406, the write event is detected, for example, when the 
memory of the communication protocol stack 280 (i.e., the send queue) is 

15 available to accept a sufficient amount of data. The data may be transmitted 
from application 260. If the polled information of block 404 is not satisfactory 
(i.e., the specified event has not occurred), then communication protocol stack 
280 continues to poll the memory, as in block 402. 

In FIG. 5, communication protocol stack 280 waits for application 260 to 

20 register a specified event, as indicated in block 500. During this time, an 
interrupt notice may be disabled. As such, the interrupt notice cannot trigger or 
be triggered. After the specified event is registered, as in block 500, the interrupt 
notice, in block 502, may be triggered based on the occurrence of the specified 
event. The read event, for example, occurs when data is written into the 

25 memory of communication protocol stack 280 (i.e., the receive queue). Thus, in 
block 504, the read event is detected by communication protocol stack 280 when 
it receives the interrupt notice, which was triggered due to the occurrence of the 
event. The data stored in the memory of the communication protocol stack 280 
may be from the communication network. Further, for the read event, the 

30 stored data may be transmitted to application 260. 

Last, the close event is detected when a socket is available for re-use 
because, for example, a data link connection, such as the transport layer, is 
terminated. 
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The following examples of an asynchronous connection (see FIG. 6) and 
an asynchronous input (see FIG. 7) are provided to illustrate the use of 
asynchronous event notification. 

Referring to FIG. 6, both communication protocol stack 280 is entered 
5 and the callback functions are specified through the call to function open_netlib 
( ). The call to function pppopen ( ) (A) initiates the network subsystem 
connection (B). After the network subsystem connection has been established, 
the callback function is invoked (C) to report the availability of the network 
subsystem. 

10 Assuming that a socket has been opened and allocated, a call to function 

connect ( ) (D) initiates a TCP connection (E). Further, application 260 calls 
function async_select ( ) (F) to register the specified events to receive 
notification. In this example, the specified event of interest is the write event, 
which occurs upon establishing a connection. 

15 Upon establishing the connection, the callback function is invoked if the 

specified event is registered in the mask. If it is, then the callback function is 
invoked (G) to provide asynchronous notification. Once application 260 is 
notified, it calls function getnextevent ( ) (H) to determine which specified event 
occurred (I). Also, this call clears the bit of the event (i.e., the write event) in the 

20 mask (J). Application 260 must re-register subsequent notification of the 
specified event through the call to function async_select ( ). 

In FIG. 7, an illustration of an asynchronous socket read is provided. To 
initiate the read, application 260 makes a call to function read ( ) (A). Assuming 
a lack of data to read, application 260 calls function async_select ( ) (B) to 

25 register an event (i.e., set the corresponding bit in the mask) to receive 
notification. In this example, the specified event of interest is the read event, 
which occurs when there is data to read by application 260. 

Upon the storage of data in the receive queue, the callback function is 
invoked if the read event is specified in the mask. If it is, then the callback 

30 function is invoked (C) to provide asynchronous notification. Once application 
260 is notified, it calls function getnextevent ( ) (D) to determine which event 
occurred (E). Also, this call clears the bit of the event in the mask (F). 
Application 260 must re-enable subsequent notification of the event through the 
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call to function async_select ( ). Last, to read the data stored in the receive 
queue, application 260 makes the call to function read ( ) (G). 

In FIGS. 8-10, state machines of embodiments of the present invention 
are illustrated. In FIGS. 8-9, it is assumed that communication protocol stack 280 
5 is opened and the network subsystem connection (i.e., traffic channel, and link 
layer if necessary — the raw sockets may bypass the network subsystem) is 
established. One skilled in the art would appreciate that various names for the 
states are possible without departing from the scope of the present invention. 

The state machine, which may asynchronously transition between states, 
10 controls (i.e., enables and disables) the specified events, such as read, write, and 
close. The specified events may be disabled at the start of operation and may be 
enabled in predetermined states to assist application 260 to identify the state of 
MS 110. 

Also, API 270 reports specified status messages that are particular (i.e., 

15 not merely generic) to application 260 based on the state of API 270 and the 
type of function called by application 260. The specified status messages may 
reflect the state of the underlying communication network. The status messages 
are reported to application 260 as arguments of the function calls, for example. 
In FIG. 8, for example, a state diagram for a TCP socket of API 270 is 

20 illustrated. The uninitialized socket begins in the "null" state 800. The socket 
does not "exist" because it has not been allocated, as of yet. The socket may be 
created and initialized through a call to function socket ( ), which returns the 
socket descriptor to use with socket-related functions. After the call to function 
socket ( ), the state machine transitions to an "initialize" state 805. 

25 In the initialize state 805, the state machine transitions back to the null 

state 800 whenever the possibility of a TCP connection is terminated by a call to 
function close ( ). The call to function close ( ) releases all socket-related 
resources. On the other hand, a call to function connect ( ) initiates the TCP 
connection and transitions the state machine into an "opening" state 810. 

30 In the opening state 810, the state machine transitions to a " closed" state 

815 whenever: (1) a network subsystem failure occurs, (2) a failure to establish 
the TCP connection, or (3) a changed IP address. Also, after a call to function 
close ( ), which terminates the TCP connection, the state machine transitions the 
socket into a "closing" state 820 while the termination procedures are initiated. 
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Last, the state machine transitions to an "open" state 825 upon the TCP 
connection being established. 

In the open state 825, the socket is open to read and write. In particular, 
the write event is immediately enabled, while the read event is enabled based 
5 on whether data is stored into the memory of the communication protocol stack 
280. The state machine transitions to the closed state 815 whenever: (1) the 
network subsystem failure occurs; (2) the failure to establish the TCP 
connection; (3) an attempt to terminate the TCP connection, such as a TCP reset, 
a TCP aborted, or a TCP closed initiated by a network server; and (4) the change 
10 of the IP address. An application initiated TCP connection termination, such as 
by a call to function close ( ), transitions the state machine to the closing state 
820. 

In the closed state 815, the read, write and close events are all asserted. 

After a call to function close ( ), which terminates the TCP connection, the state 
15 machine transitions the socket to the null state 800, which frees up the socket 

and makes it available for re-use. 

In the closing state 820, the state machine transitions to a "wait for close" 

state 830 whenever: (1) the network subsystem failure occurs; (2) the attempt to 

terminate the TCP connection, such as the TCP reset, or the TCP closed initiated 
20 by the network server; (3) an expiration of a timer and (4) the change of the IP 

address. For protection against delay in terminating the TCP connection, the 

API 270 implements the timer, which is activated upon the initiating of the TCP 

connection termination. As seen, the expiration of the timer transitions the state 

machine to the wait for close state 830. 
25 In the wait for close state 830, a call to function close ( ) terminates the 

TCP connection and transitions the state machine to the null state 800. The close 

event is asserted in this state 830. 

Tables 1-3 illustrate specified status messages supported by API 270. In 

the null state (not shown in Tables 1-3), a specified status message, which is 
30 descriptive, that "no additional resources are available" may be reported to 

application 260. 

Table 1 



State 


Specified Status Messages for a Connect Function type 


Initialize 


If this were a blocking function call, the operation would block 
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Opening 


Connection in progress 


Open 


Connection established 


Closing 


TCP connection does not exist due to lack of origination 
attempt, or the connection attempt failed 


Wait for 
Close 


TCP connection does not exist due to lack of origination 

attempt, or the connection attempt failed; or 

Generic network error; underlying network is not available 


Closed 


Generic network error; underlying network is not available; 
Connection attempt was refused due to a server reset; 
Connection in progress timed out; or 

Network level IP address changed, which caused the TCP 
connection to reset, due to a PPP resync 


Table 2 


State 


Specified Status Messages for an I/O Function type 


Initialize 


TCP connection does not exist due to lack of origination 
attempt, or the connection attempt failed 


Opening 


If this were a blocking function call, the operation would block 


Open 


If this were a blocking function call, the operation would block 
(number of bytes read /written) 


Closing 


TCP connection does not exist due to lack of origination 
attempt, or the connection attempt failed 


Wait for 
Close 


TCP connection does not exist due to lack of origination 

attempt, or the connection attempt failed; or 

Generic network error; underlying network is not available 


Closed 


Generic network error; underlying network is not available; 
Server reset the connection; receipt of a server reset; 
TCP connection aborted due to a time-out or other reason; or 
TCP connection does not exist due to lack of origination 
attempt, or the connection attempt failed 


Table 3 


State 


Specified Status Messages for a Close Function type 


Initialize 


Success — no error condition reported 
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Opening 


If this were a blocking function call, the operation would block 


Open 


If this were a blocking function call, the operation would block 


Closing 


If this were a blocking function call, the operation would block 


Wait for 
Close 


Success — no error condition reported 


Closed 


Success — no error condition reported 



By way of example, FIG. 9 illustrates a state diagram for a UDP socket of 
API 270. The uninitialized socket begins in a "null" state 900. As noted above 
with respect to the null state 800, the socket does not "exist" because it has not 
5 been allocated. The socket may be created and initialized through a call to 
function socket ( ), which returns the socket descriptor to use with socket- 
related functions. After the call to function socket ( ), the state machine 
transitions to an "open" state 905. 

In the open state 905, the socket is open to read and write. In particular, 
10 the write event is immediately enabled, while the read event is enabled based 
on whether data is stored into the memory of the communication protocol stack 
280. The state machine transitions to a "closed" state 910 whenever the network 
subsystem failure occurs. An application initiated UDP connection termination, 
such as by a call to function close ( ), transitions the state machine to the null 
15 state 900. 

In the closed state 910, the read, write, and close events are all enabled. 
After a call to function close ( ), which terminates the UDP connection, the state 
machine transitions the socket to the null state 900, which frees up the socket 
and makes it available for re-use. 
20 Tables 4-6 illustrate specified status messages supported by API 270. In 

the null state (not shown in Tables 4-6), the specified status message that "no 
additional resources are available," as stated above, may be reported to 
application 260. 

Table 4 



State 


Specified Status Messages for a Connect Function type 


Open 


Success — no error condition reported 


Closed 


Generic network error; underlying network is not available 



25 
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Table 5 



State 


Specified Status Messages for an I/O Function Type 


Open 


If this were a blocking function call, the operation would block 
(number of bytes read /written) 


Closed 


Generic network error; underlying network is not available 


Table 6 


State 


Specified Status Messages for a Close Function Type 


Open 


Success — no error condition reported 


Closed 


Success — no error condition reported 



5 FIG. 10 illustrates a state diagram to control the network subsystem, such 

as the traffic channel (i.e., Urn) and the link-layer (i.e., PPP 206). A call to 
function open_netlib ( ) opens the network subsystem, and initializes a socket 
into a "closed" state 1000. A call to function pppopen ( ) initiates the network 
subsystem connection, which transitions the socket to an "opening" state 1005. 
10 Also, a page to the MS 110 by an incoming PPP call transitions the socket to the 
opening state 1005. In both cases, upon successful negotiation, the MS 110 
attempts to synchronize and establish both RLP and PPP across the traffic 
channel. 

In the opening state 1005, the socket transitions to an "open" state 1010 
15 upon the network subsystem connection being established. On the other hand, 
the socket transitions back to the closed state 1000 if the network subsystem 
connection is not established. 

In the open state 1010, the callback function is invoked to identify to 
application 1060 specified events, such as read, write, and close, that are 
20 enabled. At this time, the MS 110 can communicate through the traffic channel. 
The socket, however, transitions to the closed state 1000 whenever network 
subsystem failure occurs, which invokes the callback function. An application 
initiated network subsystem connection termination, such as by a call to 
function close ( ), transitions the socket to a "closing" state 1015. 
25 In the closing state 1015, the socket transitions to the closed state 1000 

whenever the network subsystem connection is terminated. In the closed state 
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1000, the callback function is invoked to identify to application 260 specified 
events that are enabled. 



Table 7 illustrates specified status messages that correspond to particular 
function calls, and that are supported by API 270. 
5 Table 7 



Function Call (and 
description) 


Specified Status Messages 


socket ( ) 

creates a socket and 
returns a socket descriptor 


Address not supported; 

Invalid Application Identifier; 

Protocol is wrong type for socket; 

Invalid or unsupported socket parameter; 

Protocol not supported; or 

No more socket resources available 


connect ( ) 

initiates TCP connection 


If this were a blocking function call, the operation 

would block; 

Invalid socket descriptor; 

Connection attempt was refused due to receipt of 
a server reset; 
Connection timed out; 

Application buffer not part of valid address 
space; invalid size specified for address length or 
message length; 

Network level IP address changed, which caused 

the TCP connection to reset, due to a PPP resync; 

Connection in progress; 

Socket descriptor already connected; 

Generic network error; underlying network is 

unavailable; 

Invalid server address specified; 
Address already in use; or 
Destination Address Required 


pppopen ( ) 

establishes network 
connection 


If this were a blocking function call, the operation 
would block; 

Invalid application identifier specified; or 
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Termination of network connection in progress 


net_ioctl ( ) 

sets network 
characteristics 


Invalid application identifier specified; 
Invalid request or parameter; 
Network connection established; or 
Network connection in progress 


open_netlib ( ) 
opens communication 
protocol stack 


No more applications available — maximum 
number of open applications exceeded 


close_netlib ( ) 
closes communication 
protocol stack 


Invalid application identifier specified; 
There are existing, allocated sockets; or 
Network connection is still established 


bind ( ) 

for client sockets, attaches 
a local address and port 
value to the socket 


Invalid socket descriptor specified; 

Invalid or unsupported operation specified; 

Address already in use; 

Invalid operation; or 

Invalid address parameter specified 


close ( ) 

closes a socket to free it for 
re-use 


Invalid socket descriptor specified; or 

If this were a blocking function call, the operation 

would block 


pppclose ( ) 

closes network connection 


If this were a blocking function call, the operation 
would block; 

Invalid application identifier specified; or i 
Termination of network connection in progress 


netstatus ( ) 

reports status of network 
connection 


Invalid application identifier specified; 

Underlying network is unavailable; 

Network connection established and available; 

Network connection in progress; 

Termination of network connection in progress; 

No CDMA (i.e., traffic channel) service available; 

CDMA service available, but origination failed 

because base station does not support service 

option; or 

CDMA service available, but origination failed; 
however, not because base station does not 
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support the service option 


7\ c:\rn c <?p1pr*t" ( i 


Invalid so^Wpt Hp^crir) tor snpfifipH 


registers specified events 




for a ^articular socket 
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descriptor and events that 




have occurred 




write ( ) 


Invalid socket descriptor specified; j 


write a specified number 


No existing TCP connection; 


of bytes — contiguous or 


Server reset the TCP connection; 


non-contiguous buffers 


TCP connection aborted due to timeout or other 
failure; 

Network level IP address changed, which caused 
the TCP connection to reset, due to a PPP resync; 
TCP connprtion rlospd* 

MpITATTItV 11Tl3\7^l1artlp* 
1MCLWU1JS HI Id V CtllCt L/1G, 

Annl ica ti on VmffpT nnf vaIi^ TiPiTi* o f piHrlfp**** 
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space; or 

No free buffers available for writing 


read ( ) 


Invalid socket descriptor specified; 


read a specified number of 


No existing TCP connection; 


bytes — contiguous or non- 


Server reset the TCP connection; 


contiguous buffers 


TCP connection aborted due to timeout or other 
failure; 

Network level IP address changed, which caused 
the TCP connection to reset, due to a PPP resync; 
TCP connection closed; 
Network unavailable; 

Application buffer not valid part of address 
space; 

No free buffers available for reading; or 
End of file marker received 


sendto ( ) 


Invalid socket descriptor specified; 
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send a specified number of 
bytes 


Address family not supported; 

No free buffers available for writing; 

Network unavailable; 

Application buffer not valid part of address 
space; 

Specified option not supported; or 
Destination address requested 


recvfrom ( ) 

reads a specified number 
of bytes 


Invalid socket descriptor specified; 
Address family not supported; 
No free buffers available for writing; 
Network unavailable; 

Application buffer not valid part of address 
space; or 

Specified option not supported 



In another embodiment, a machine may read a machine-readable 
medium comprising encoded information, such as encoded software code, to 
cause the processes described above that enables a mobile station application to 
5 identify specified events. The machine-readable medium may accept the 
encoded information from a storage device, such as a memory or a storage disk, 
or from the communication network. Also, the machine-readable medium may 
be programmed with the encoded information when the medium is 
manufactured. The machine may comprise at least one of application 260, 
10 communication protocol stack 280, and API 270, while the machine-readable 
medium may comprise a memory or a storage disk. 

Although this invention has been shown in relation to particular 
embodiments, it should not be considered so limited. Rather, the invention is 
limited only by the scope of the appended claims and their equivalents. 

15 

We claim: 
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CLAIMS 

1. A method for a mobile station application to identify a plurality of 
2 specified events, the method comprising: 

communicating between a mobile station communication protocol stack 
4 and a communication network; 

communicating between the mobile station communication protocol 
6 stack and the mobile station application through a mobile station application 
interface; 

8 enabling, by the mobile station application interface, at least one of the 

specified events based on the state of the mobile station application interface; 
10 and 

identifying, by the mobile station application, the specified events that 
12 are enabled. 

2. The method of claim 1, wherein the mobile station application identifies 
2 the specified events that are enabled by calling a function. 

3. The method of claim 1, wherein the mobile station application interface 
2 comprises a plurality of states. 

4. The method of claim 3, wherein the mobile station application interface 
2 asynchronously transitions between the states. 

5. The method of claim 1, wherein the plurality of the specified events include at 
2 least one of a read, write, and close events. 

6. The method of claim 1, further comprising the mobile station application 
2 interface disabling at least one of the specified events based on the state of the mobile 

station application interface. 

7. The method of claim 5, wherein the write event is enabled whenever a 
2 communication network connection is established. 
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8. The method of claim 5, wherein the read event is enabled whenever a 
2 communication network connection is established, and data is stored into a 

memory of the mobile station communication protocol stack. 

9. The method of claim 5, wherein the read, write, and close events are 
2 enabled whenever a communication network failure occurs. 

10. The method of claim 5, wherein the read, write, and close events are 
2 enabled whenever, 

a failure to establish a communication network connection, 
4 an attempt to terminate the communication network connection, or 

a change of a network identification address. 

11. The method of claim 10, wherein the network identification address 
2 includes an IP address. 

12. The method of claim 5, wherein the close event is enabled whenever, 
2 a communication network failure occurs, 

an attempt to terminate a communication network connection, 
4 an expiration of a timer, or 

a change of a network identification address. 

13. The method of claim 12, wherein the network identification address 
2 includes an IP address. 

14. The method of claim 12, wherein the timer is activated upon the initiation to 
2 terminate the communication network connection. 

15. The method of claim 5, wherein the write event is enabled whenever a 
2 socket is allocated. 

16. The method of claim 5, wherein the read event is enabled whenever a 
2 socket is allocated, and data is stored into a memory of the mobile station 

communication protocol stack. 
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17. An apparatus for a mobile station application to identify a plurality of 
2 specified events, the apparatus comprising: 

a mobile station communication protocol stack to communicate with a 
4 communication network; 

a mobile station application interface to enable at least one of the 
6 specified events based on the state of the mobile station application interface; 
and 

8 a mobile station application to identify the specified events to be enabled, 

wherein the mobile station application interface is adapted to facilitate 
10 communications between the mobile station application and the mobile station 
communication protocol stack. 

18. The apparatus of claim 17, wherein the mobile station application is 
2 adapted to identify the specified events to be enabled by a function call. 

19. The apparatus of claim 17, wherein the mobile station application 
2 interface comprises a plurality of states. 

20. The apparatus of claim 19, wherein the mobile station application 
2 interface is adapted to asynchronously transition between the states. 

21. The apparatus of claim 17, wherein the plurality of the specified events include 
2 at least one of a read, write, and close events. 

22. The apparatus of claim 17, wherein the mobile station application interface is 
2 adapted to disable at least one of the specified events based on the state of the mobile 

station application interface. 

23. A machine-readable medium comprising encoded information, which 
2 when read by a machine causes the processes of: 

communicating between a mobile station communication protocol stack 
4 and a communication network; 
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communicating between the mobile station communication protocol 
6 stack and a mobile station application through a mobile station application 
interface; 

8 enabling, by the mobile station application interface, at least one of 

specified events based on the state of the mobile station application interface; 
10 and 

identifying, by the mobile station application, the specified events that 
12 are enabled. 

24. The machine-readable medium of claim 23, wherein the mobile station 
2 application identifies the specified events that are enabled by calling a function. 

25. The machine-readable medium of claim 23, wherein the mobile station 
2 application interface comprises a plurality of states. 

26. The machine-readable medium of claim 25, wherein the mobile station 
2 application interface asynchronously transitions between the states. 

27. The machine-readable medium of claim 23, wherein the plurality of the 
2 specified events include at least one of a read, write, and close events. 

28. The machine-readable medium of claim 23, further comprising the 
2 mobile station application interface disabling at least one of the specified events 

based on the state of the mobile station application interface. 
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